eDocs Home > BEA AquaLogic Data Services Platform 3.0 Documentation > Data Services Developer's Guide
If you intend to access a data service through web services using the Data Services Mediator API, you must generate a web service map file first. A web service map file maps data service functions to web service operations. The map file is also used for setting and configuring security policies for web services applications.
This section includes these topics:
This section describes the basic steps that are required to create a map file. You can accomplish all of these tasks using the ALDSP Eclipse IDE. The procedure assumes that you have created or have access to a valid data service (.ds) file.
For information on the contents of the web service map file, see Web Services Map File Reference.
There are two ways to create a web service map file (.ws file):
Method 1:
- Obtain access to the Data Service project that you wish to access from a web service and import it into your Dataspace project.
- Right-click on the data service name in Project Explorer and select Create Web Service Map. The map file (.ws file) is created with the same name as the data service file, and the map file is opened in the editor.
Method 2:
- Obtain access to the Data Service project that you wish to access from a web service and import it into your Dataspace project.
- Right-click on the data service name in Project Explorer and select New > Web Service Map.
- Use the dialog to create an empty web service map file with a name of your choosing. The empty map file opens in the editor.
- Drag either an entire data service file onto the map file or drag individual data service operations.
The following figure shows a data service file called CUSTOMER.ds added to a map file called myMapper.ws (created using Method 2).
Only the data service functions that are mapped in the map file are available to clients. Only public data service operations can be mapped.
You can examine the generated WSDL file. See Web Services Map File Reference for details.
You can test the generated WSDL file. See Web Services Map File Reference for details.
This section describes additional ways to add data services and operation to a map, and how to delete operations from an existing map.
You can drag and drop either an entire data service or individual data service operations from the Project Explorer onto an existing map file in the map file editor.
You can right-click in the map editor and select Add Data Services/Operations to Map. Use the Select Resources to Add to Map dialog to add data service resources to the map.
To delete one or more operations, select the operations and right-click on the selected operations, and then select Delete.
To delete all operations that are related to a .ds dataservice, right-click on the .ds dataservice box and select Delete.
